home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / business / gohom10a.zip / GOHOME.HLP < prev    next >
Text File  |  1994-04-30  |  28KB  |  691 lines

  1. Help file for GoHome.
  2.  
  3. @@Contents
  4. HelpOnHelp   : `1Help on Help`0
  5. Overview     : `1GoHome Overview`0
  6. CommandLine  : `1Command line parameters`0
  7. HotKey       : `1Changing the Hot-Key`0
  8. ConfigFile   : `1Using a config file`0
  9. @@SectionHdr :
  10. @@SectionHdr :             `2GoHome Main Menu `0
  11. @@SectionHdr :
  12. MainMenu     : `1Main Menu`0
  13. GoSchedule   : `1GoSchedule`0      Run the GoSched program
  14. Record       : `1Record Script`0   Start recording a script
  15. Playback     : `1Playback Script`0 Playback a script file
  16. RunTask      : `1Run a Task`0      Run a task
  17. DOSShell     : `1DOS Shell`0       Run the DOS shell
  18. BlankScreen  : `1Blank Screen`0    Blank the screen
  19. Suspend      : `1Suspend Tasks`0   Suspend scheduled tasks
  20. @@SectionHdr :
  21. @@SectionHdr :             `2Task Types`0
  22. @@SectionHdr :
  23. Batch        : `1Batch Files`0     Run a DOS batch file (.bat)
  24. Command      : `1Command(s)`0      Run a number of commands
  25. Script       : `1Script`0          Playback a script file
  26. Reminder     : `1Reminder`0        Display a reminder message
  27. @@SectionHdr :
  28. @@SectionHdr :             `2Miscellaneous`0
  29. @@SectionHdr :
  30. MemReq       : `1Memory Usage`0
  31. SchedTasks   : `1Scheduling Tasks`0
  32. TaskDataFile : `1Task Data File`0
  33. PopCntDown   : `1Countdown Window`0
  34. Log          : `1Log file`0
  35. ChgTime      : `1Read this if your change your computers time`0
  36. @@EndContents
  37.  
  38.  
  39.  
  40. @@Help
  41. [HelpOnHelp]
  42. To use help, select the topic you want help on from the topics
  43. list (enter 'T' to get back to the topics list). Use the
  44. cursor and page keys to scroll through the text. The `2 Next`0
  45. and `2 Previous `0 buttons move to the next and previous
  46. topic, respectively.
  47.  
  48. All of the buttons in `1GoHelp`0 can be executed by simply
  49. pressing the key that is highlighted on the button. You can
  50. also TAB to the button or press it's accelerator key (press
  51. <ALT> + key hightlighted on button label).
  52.  
  53. To get help on a particular program, run `1GoHelp`0 with the
  54. first argument on the command line set: `1GoHome`0,
  55. `1GoScript`0, `1GoSched`0, or `1GoEd`0. You can also run
  56. `1GoHelp`0 with no arguments, in which case you will be
  57. presented with a menu to select the program you want help on.
  58.  
  59.  
  60. [Overview]
  61. `1GoHome`0 is a `1Task Scheduler`0 and a `1Program Automator`0.
  62. It allows you to get more out of your computer by letting you
  63. schedule programs to run unattended. It also helps you to be
  64. more productive with the applications you use everday through
  65. its powerful scripting capabilities. All of `1GoHome`0's 
  66. powerful capabilities are available at the touch of a key and
  67. at anytime.
  68.  
  69. `1GoHome`0 has a very flexible scheduler that allows you to
  70. run tasks whenever it's necessary. Tasks can be scheduled to
  71. run at any time, day or night. You'll often want to schedule
  72. programs late at night (for instance, dial-up a BBS and
  73. download data when the phone charges are cheaper) or when
  74. resources are less busy (print documents when the printer
  75. isn't being used), etc. Tasks can be scheduled to run on
  76. specific weekdays (ie. every Monday, Wednesday, Friday),
  77. specific days of the month (ie. on the 1st and 15th day of
  78. every month), or on a specific date (ie. November 1, 1994).
  79. Tasks can even be scheduled to run at designated intervals
  80. throughtout the day (ie. run every 10 minutes between 11:00 am
  81. and 5:00 pm). 
  82.  
  83. As well as scheduling programs, `1GoHome`0 can also be
  84. taught to run programs from start to finish. This allows you
  85. to run programs that require keyboard input `1auto-magically`0!
  86. It's even possible to use `1GoHome`0 as a sophiscated "keyboard"
  87. macro program to execute specfic tasks within a program.
  88.  
  89. `1GoHome`0 goes way beyond what traditional keyboard macro 
  90. programs can do. In addition to memorizing the keystrokes and
  91. the delays between them, `1GoHome`0 can also wait until a
  92. portion of the screen contains a specific pattern of text,
  93. prompt you for additional data, display menus, print to a 
  94. printer or file, enter time and date information, and many,
  95. many more features.
  96.  
  97. `1GoHome`0 calls a sequence of events a `2script`0. Scripts
  98. may be of varying length up to a max of approximately 32K. The
  99. size of the script or the number of scripts created does not
  100. affect the size of the resident portion of `1GoHome`0.
  101.  
  102. `1GoHome`0 also comes with a very easy to use task scheduler,
  103. script editor, file editor (for quickly editing batch and
  104. other small files), and a complete context sensitive help
  105. system. See `2Help On Help`0 for infomation on how to get
  106. help for these programs or consult the manual. 
  107.  
  108.  
  109.  
  110. [CommandLine]
  111. The syntax for running `1GoHome`0 is:
  112.  
  113.   gohome [`1parameters`0] [`1configFile`0] 
  114.  
  115. where
  116.  
  117. `1parameters`0 can be any number of the following:
  118.  
  119. /U              Remove `1GoHome`0 from memory
  120. /F=`1tskFile`0      Schedule the tasks in `1tskFile`0. If a path
  121.                 is not specified, the current directory is used.
  122. /RUN=`1x`0          Run the `1x`0-th task immediately
  123. /PLAY=`1script`0    Play the specified script file. This option
  124.                     is generally used to run scripts from a 
  125.                     batch file.
  126. /BLNK=`1x`0         Blank screen after `1x`0 minutes
  127. /ALLOC=`1x`0        Allocate room for an extra `1x`0 tasks
  128. /MAX=`1x`0          Allocate room for a maximum of `1x`0 tasks
  129.                 `1x`0 must be between 5 and 100.  This option
  130.                 is only used when creating a new task data file
  131. /EMS            Don't swap to EMS, even if available
  132. /XMS            Don't swap to XMS, even if available
  133. /SUSPEND=[`1Y`0|N]  Suspend any tasks that are scheduled
  134. /SHUSH=[`1Y`0|N]    Run silently (no bells or whistles)
  135. /CSET=[b|m|`11`0|2|3|4 Select color set `1x`0
  136. /DBG=[`1Y`0|N]      Display script actions during playback
  137. /DUMPDBG        Do not go resident with script debug info
  138. /DPMthd=[`10`0|1]   When at DOS Prompt: 0 -> stuff commands; 
  139.                                       1 -> swap
  140. /NOHI           Program has not been loaded into High Memory
  141. /HK=`1x`0           Change Hot-Key to `1x`0 
  142.                 Default hotkey is `1<Ctrl><SPACE>`0
  143.                 (See the next section `3Changing the Hot-Key`0 for
  144.                 more detail)
  145.  
  146.  
  147. For information on `3config files`0 see `2Using a config file`0.
  148.  
  149. [HotKey]
  150. You can change the hot-key (default hotkey is `1<Ctrl><SPACE>`0) by
  151. using the `1/HK=x`0 command line parameter. Combine the folowing
  152. characters to specify a new hot-key:
  153.  
  154.         To specify Alt, Ctrl, and Shift keys use:
  155.              A  => Left Alt
  156.              RA => Right Alt
  157.              S  => Left Shift
  158.              RS => Right Shift
  159.              C  => Left Ctrl
  160.              RC => Right Ctrl
  161.  
  162.          For function keys use:
  163.              F1, F2, ..., F10, F11, F12
  164.  
  165.          Special keys are specified using:
  166.              \r => Enter 
  167.              \t => Tab  
  168.              \l => Cap Lock 
  169.              \b => Back space 
  170.              \s => space 
  171.              \e => Esc
  172.              \\ => \
  173.              \f => / 
  174.  
  175.          Numeric keypad keys
  176.              \1 => 1 or End
  177.              \2 => 2 or Down arrow
  178.                .. 
  179.              \0 => 0 or Ins
  180.              \. => . or Del
  181.  
  182.         Use the plus (+) sign to concatenate keys. If there
  183.         are no Ctrl/Shift/Alt flags in your hot-key you must
  184.         preceed the hot-key definition with '+'. 
  185.  
  186.         Examples:
  187.  
  188.            /HK=`1x`0       Hot key(s) used to invoke `1GoHome`0
  189.            ------     ---------------------------------------
  190.             CS+A   => <Ctl><Shift>A
  191.             A+F12  => <Left Alt><F12>
  192.             S+F11  => <Left Shift><F11>
  193.             +F12   => <F12>
  194.             C+\B   => <Ctrl><Backspace>
  195.             A+\t   => <Alt><TAB>
  196.             C+\.   => <Ctrl><Numeric keypad's <Del> key>
  197.             A+\5   => <Alt><Numeric keypad's <5> key>
  198.  
  199.  
  200. [ConfigFile] 
  201. A config file is used by all the programs to avoid having to
  202. enter command line parameters every time you run the program. 
  203. A config file is an ordinary text file that contains any
  204. number of command line parameters that you want to have set
  205. each time you run the program. 
  206.  
  207. The config file to use is indicated on the command line
  208. preceded with an '@' charcter (ie. gohome @goho.cfg).  If a
  209. config file is not specifed on the command line, `1GoHome`0
  210. looks for the file `1gohome.cfg`0 in the same directory as
  211. gohome.exe. If a config file is specified or `1gohome.cfg`0
  212. exists, all parameters in that file will be processed
  213. `1before`0 processing any of the command line parameters. This
  214. allows you to store a common configuration in a config file
  215. but still be able to override it on the command line. 
  216.  
  217. The following is a list of default config files used by the
  218. `1GoHome`0 programs:
  219.  
  220.         Program      Default config file
  221.        ---------    ---------------------
  222.       `1GoHome`0           GOHOME.CFG
  223.       `1GoSched`0          GOSCHED.CFG
  224.       `1GoScript`0         GOSCRIPT.CFG
  225.       `1GoEd`0             GOED.CFG
  226.       `1GoHelp`0           GOHELP.CFG
  227.  
  228.  
  229.  
  230.    ******* GoHome menu items ********
  231.  
  232. [MainMenu]
  233. To activate `1GoHome`0's main menu, press the defined hot-key.
  234. The default hot-key for `1GoHome`0 is `2<Ctrl-SPACE>`0 (hold down 
  235. the <Ctrl> key and tap the space bar). 
  236.  
  237. The hot-key used to pop-up `1GoHome`0 may be redefined to 
  238. another key sequence that you prefer or to one that doesn't
  239. interfere with any applications you may run. You define a
  240. hot-key by using the `1/HK=xxx`0 option on the command line or
  241. in `1GoHome.cfg`0. See the help section under `2Command line`0
  242. `2parameters`0 for information on how to specify the hot-key and
  243. for samples.
  244.  
  245. When chosing a hot-key, you should consider using a key 
  246. sequence that won't interfere with any of the programs you may
  247. run. Generally, you should stay away from using the `2<ALT>`0 key
  248. since many programs use that key to highlight an item in the
  249. menubar. If you'll be running `1GoHome`0 in a DOS box under MS
  250. Windows, avoid any Window defined hot-keys such as
  251. `2<Ctrl><Esc>`0. 
  252.  
  253. See also `4Command line parameters`0
  254.  
  255. [GoSchedule]
  256. Select `2GoSchedule`0 from `1GoHome`0's main menu to envoke
  257. the program scheduler, `1GoSched`0. `1GoSched`0 can also be
  258. run from the DOS command line, however, using the main menu is
  259. simpler and it allows you to pop-up the scheduler even if
  260. you're in the middle of another program.
  261.  
  262. If you want to run a task and you don't recall its task
  263. number, bring up `1GoSched`0 which will display a list of
  264. tasks from which you can then execute.
  265.  
  266. See also `4Run a Task`0 and `4Main Menu`0
  267.  
  268. [Record] 
  269. Selecting `2Record Script`0 will enter `1GoHome`0's record
  270. mode. Record mode allows you to "teach" `1GoHome`0 how to run
  271. a program. In this mode, `1GoHome`0 changes the main menu to a
  272. recording menu that lists a subset of the script items that
  273. can be entered into the script being recorded. 
  274.  
  275. The record menu contains the script commands that are
  276. frequently used and most of which are "interactive". By
  277. interactive we mean that they require some form of input for
  278. the user. For example, selecting `2Start Key Recording`0 from
  279. the menu tells `1GoHome`0 to record all the keystrokes that
  280. you enter and the time interval between keypresses. If you
  281. select `2WaitAtPos`0 or `2WaitRelCrs`0 you'll be
  282. prompted to select the region on the screen that is to be
  283. watched (examined) for a given text pattern.  
  284.  
  285. As stated previously, the script commands in the record menu
  286. are a subset of the available script commands. Once the
  287. interactive or general format of a script has been recorded,
  288. you may want to add additional script commands by using the
  289. script editor, `1GoScript.exe`0. For information on
  290. `2GoScript`0 see the on-line help (at the DOS command line
  291. enter 'gohelp goscript') or the manual.
  292.  
  293. The following is a brief overview of the script commands 
  294. available from the record menu:
  295.  
  296.     Keys                   - Record all keystrokes and the 
  297.                              time interval between them.
  298.     WaitKeyBuff            - Wait until all the keys in the
  299.                              keyboard buffer have been read in
  300.                              by the program currently running.
  301.                              (Note: the program currently 
  302.                              running may be the DOS command 
  303.                              prompt).
  304.     Delay                  - Pause playing back the script for
  305.                              a specified number of seconds.
  306.     WaitAtPos              - Wait until the specified text 
  307.                              appears in a defined section of
  308.                              the display. A timeout value may
  309.                              be specified when the script 
  310.                              editor (`2GoScript.exe`0) is used. 
  311.     WaitRelCrs             - Wait until the specified text
  312.                              appears relative to the current
  313.                              cursor position. A timeout value
  314.                              may be specified when the script 
  315.                              editor (`2GoScript.exe`0) is used. 
  316.     Comment                - Enter a comment. A comment is 
  317.                              used to describe what the script
  318.                              is doing. This description can
  319.                              be anything that you feel is 
  320.                              important to remember - it is
  321.                              not used by `1GoHome`0. It may 
  322.                              also be useful to make notes of
  323.                              script commands that you want to
  324.                              add using `1GoScript`0.
  325.     Beeper                 - Make a beeping noise. The type of
  326.                              beep that is made can be changed
  327.                              by modifying it in `1GoScript`0.
  328.     Save Macro             - Stop recording the script and
  329.                              save it to file.
  330.  
  331.  
  332.  
  333. See also `4Playback Script`0 and the on-line help for `4GoScript`0
  334.  
  335. [Playback]
  336. Selecting `2Playback Script`0 from the main menu will bring
  337. up a dialog box for entering the script file to play. This
  338. is an easy way for playing scripts that perform "tasks"
  339. within a program. 
  340.  
  341. If the script that you want to play back is meant to be run
  342. from the DOS command line, you'll need to make sure that
  343. it's started there. 
  344.  
  345. An alternative to running scripts that must start at the DOS
  346. command line is to schedule them using `1GoSched.exe`0 (use
  347. `1GoHome`0's main menu and select `2GoSchedule`0). Once in
  348. `1GoSched`0, bring up the Advanced dialog box and make sure
  349. that the `2Start Script at the DOS Prompt`0 check box is
  350. checked. Now that the task is scheduled you can run it using
  351. the `2Run a Task`0 item from the main menu. If you are not at
  352. the DOS command line, `1GoHome`0 will swap out the current
  353. application and start a new copy of the DOS command processor
  354. (COMMAND.COM) before starting the script. If you are already at
  355. the DOS command line, then `1GoHome`0 won't start up another
  356. DOS command processor, it'll type in the commands just as you
  357. would.
  358.  
  359. See also `4Run a Task`0  `4Record Script`0  `4GoSched Help`0
  360.  
  361. [RunTask]
  362. Selecting the `2Run a Task`0 item from `1GoHome`0's main menu
  363. will pop-up a dialog box requesting the number of the task to 
  364. run. Use `2Run a Task`0 to execute a task that has been 
  365. assigned using `1GoSched`0. 
  366.  
  367. The number of the task is the number of the task in the
  368. `1GoSched`0's Task List. You can move tasks while in `1GoSched`0
  369. by first pressing `2F7`0 to delete the task and then moving to the 
  370. task number that you want to place it at and entering `2F8`0 to
  371. paste the task.
  372.  
  373. Since numbers are hard to remember, `1GoHome`0 also accepts
  374. single characters in place of a task number. The characters 
  375. are mapped directly to a number by assigning the letter 'A' to
  376. 1, 'B' to 2, ..., and 'Z' to 26. Note that this only works for
  377. the first 26 tasks. Lowercase is treated the same as uppercase
  378. letters. 
  379.  
  380. As an example, you could assign a task that does your backup
  381. to task 2 (or 'B') for backup; or assign task 5 (or 'e') to
  382. bring up you text editor with a default file loaded.
  383.  
  384. As an alternative to using the `2Run a Task`0 command, you can simply
  385. bring up `1GoSched`0 (from main menu select `2Run a Task`0),
  386. position the highlight line in the Task List to the task to
  387. run, and press `2F4`0 to run the task. `1GoSched`0 will quit
  388. and the task will run. You may want to add the option `2/LIST`0
  389. to `1GoSched`0's config file to display only the Task List.
  390.  
  391. See also `4GoSched`0 help file
  392.  
  393.  
  394. [DOSShell]
  395. Selecting `2DOS Shell`0 from the main menu will swap out the
  396. current application and start up a new copy of the DOS command
  397. processor. At this point you can do whatever you want to. When
  398. you're done, type "EXIT" at the DOS prompt to return right
  399. where you left off in your application.
  400.  
  401. IMPORTANT: In order to determine the DOS command processor
  402. you're using, `1GoHome`0 will look for 'COMSPEC=xxx' in your
  403. environment table. It's important for this variable to be set
  404. to a valid command processor. Check your AUTOEXEC.BAT file
  405. for a statment similar to 'SET COMSPEC=xxx' where 'xxx' is
  406. the location and name of your DOS command processor. Typically,
  407. COMSPEC will be set to C:\COMMAND.COM or C:\DOS\COMMAND.COM.
  408. If you're using NDOS then C:\NORTON\NDOS.COM or if 4DOS then
  409. C:\4DOS\4DOS.COM.
  410.  
  411.  
  412. [BlankScreen]
  413. Selecting `2Blank Screen`0 from the main menu will immediately
  414. blank the screen. `1GoHome`0 can be configured to blank the
  415. screen after a certain period of time has elapsed since a key
  416. was pressed.  This screen timeout period can be specified with
  417. the `1/BLNK='xxx'`0 command line option where 'xxx' is the
  418. number of minutes to wait after a key was pressed before
  419. blanking the screen. The default timeout interval in 5
  420. minutes. 
  421.  
  422. The screen is immediately un-blanked when any key is pressed.
  423.  
  424. The timeout interval can also be set through the 
  425. `2Blank Screen`0 command in `1GoScript`0.
  426.  
  427.  
  428. See also: `4GoScript`0 help file.
  429.  
  430. [Suspend]
  431. Selecting the `2Suspend Tasks`0 menu item from `1GoHome`0's main 
  432. menu will temporarily suspend all scheduled tasks. Once tasks
  433. are suspended, the `2Suspend Tasks`0 menu item changes to
  434. `2Resume Tasks`0 and all the other menu items, except `2Blank Screen`0,
  435. are disabled. Selecting `2Resume Tasks`0 will re-enable all
  436. scheduled tasks.
  437.  
  438. You will want to suspend tasks when you are in the middle of
  439. something that you don't want to be interrupted. It is also
  440. very IMPORTANT that you suspend all tasks when running a
  441. program that may modify your hard disk or requiers that it not
  442. be interrupted. Examples of this type of program are disk
  443. compression utilities.
  444.  
  445. Note that tasks may also be suspend by running `1GoHome`0 again
  446. but with the `2\suspend`0 parameter. Running `1GoHome`0 with
  447. this parameter will notify the resident version to suspend
  448. tasks. 
  449.  
  450. To avoid having `1GoHome`0 interfere with these types of programs
  451. you can make sure that these programs are only run by having
  452. `1GoHome`0 run them for you (ie. enter a task in `1GoSched`0
  453. that will run the application at a specified time or manually
  454. by using the `2Run a Task`0 option). Another option would be to
  455. create a batch file that suspends the tasks, runs the program, and
  456. then resumes the tasks. For example,
  457.  
  458.         gohome /suspend=y
  459.         REM run disk commpression/defrager
  460.         diskfrag.exe
  461.         gohome /suspend=n
  462.  
  463.  
  464.      ******* Task Types ********
  465.  
  466. [Batch]
  467. This type of task is used to run a batch file. It's important 
  468. that the batch file is either in your PATH or that you specify 
  469. the full path of the batch file so that `1GoHome`0 can find it
  470. no matter what the current directory may be. 
  471.  
  472.  
  473. [Command]
  474. For a command task, you specify one or more commands just as
  475. you would if they were typed in at the DOS command line. For
  476. multiple commands, use a semi-colon (';') to seperate them.
  477. For example, the following would list the contents of the
  478. current directory and then list the amount of memory you
  479. have available:
  480.    
  481.        DIR; MEM /C
  482.  
  483. [Script]
  484. To have `1GoHome`0 play back a script file, pop-up GoHome's menu
  485. with the hotkey (default is <Ctrl-SPACE>) and press the letter
  486. <P>. You will be prompted for the script file to play. If a
  487. directory isn't specified, GoHome will use its home directory
  488. to find the file. 
  489.  
  490. [Reminder]
  491. A reminder will pop-up a window at the specified time. You may
  492. display a message of up to 128 characters. Use reminders to
  493. notify you of appointments or things to do.
  494.  
  495. IMPORTANT: If `1GoHome`0 is in the middle of running a task,
  496. all `2Reminders`0 are post-poned until that task finishes.
  497. If the task is a long one then the reminder may not appear
  498. at its scheduled time. 
  499.  
  500. When the scheduled time arrives and assumming that a task isn't
  501. already running, `1GoHome`0 pops-up a window, displays your
  502. text, and waits for you to hit the <Enter> key. If the <Enter>
  503. key is not hit after one minute, `1GoHome`0 will bring down
  504. the window. It does this in case you have a program currently
  505. running or a task is scheduled after it. If it didn't remove
  506. the Reminder window, any program that happend to be running
  507. would be suppended until you removed the Reminder and all tasks
  508. that were scheduled wouldn't be able to run until <Enter> was
  509. pressed.
  510.  
  511. `1GoHome`0 keeps a list of all the Reminders that you missed
  512. and will display them the first time you hit any key. If 
  513. `1GoHome`0 is in the middle of running a task, then the Reminders
  514. aren't shown until after the task completes.
  515.  
  516.  
  517.   ***** Misc ******
  518.  
  519. [MemReq]
  520. `1GoHome`0 is a TSR that requires appoximately 40K of
  521. conventional memory. Each task requires only 10 bytes of
  522. memory. When a task is due, `1GoHome`0 will read the task
  523. data file to get the rest of the information necessary to run
  524. the task. Script files may be of any size up to approximately
  525. 32K. `1GoHome`0 uses a fixed internal buffer that pages
  526. portions of the script file into memory. This enables it to
  527. run script files of varying length without requiring
  528. additional conentional memory be used.
  529.  
  530. When it comes time to run an task, `1GoHome`0 first checks to
  531. see if the computer is at the DOS prompt. If it is not,
  532. `1Gohome`0 will swap the program out of memory to make more
  533. memory availble to the task about to run. When the task
  534. completes, the swapped out program is returned to its original
  535. running condition. If there is no program currently running
  536. and the computer is at the DOS prompt, `1GoHome`0 will not
  537. have to swap out any programs to make room for the task.
  538.  
  539. If it is necessary for `1GoHome`0 to swap out the program
  540. currently running, it has three options of where to store the
  541. progam's "image":  XMS, EMS, or the hard drive. Where it swaps
  542. to will affect system performance. Both XMS and EMS are fast
  543. while saving to the hard drive can be somewhat slow. 
  544.  
  545. When it has to swap, `1GoHome`0 will first check to see if XMS
  546. memory is avaible and that the required amount of XMS memory
  547. is availble. If so, it will use XMS. If XMS is not availble,
  548. it will next check to see of EMS memory is availble. If not,
  549. it lastly tries to swap the program to the hard drive
  550. specified by the environment variable, `3TEMP`0. If
  551. insufficient disk space is available, the task will not be
  552. run. 
  553.  
  554. You can tell `1GoHome`0 to not use either XMS or EMS by
  555. specifying on the command line the following parameters,
  556. `3/XMS`0 and `3/EMS`0, respectively. There is also an option
  557. in `1GoSched`0 in the `2Options`0 dialog box to specify that
  558. when swapping this particular task, swap it to the hard drive.
  559. This may be necessary if the program uses XMS or EMS memory
  560. and there may not be enough availble to the program if
  561. `1GoHome`0 XMS or EMS also.
  562.  
  563.  
  564. [SchedTasks]
  565. Tasks are scheduled using `1GoSched`0 (see help or manual for
  566. details on using `1GoSched`0). An easy way to run `1GoSched`0
  567. is to select it in `1GoHome`0's main menu. `1GoSched`0
  568. communicates with `1GoHome`0 and updates `1GoHome`0 with any
  569. scheduling changes that were made.
  570.  
  571. When it's time to run a task, `1GoHome`0 will pop-up a countdown
  572. window. If you do not cancel the task or respond within fifteen
  573. seconds `1GoHome`0 will proceed to run the task (see also 
  574. `4Countdown Window`0).
  575.  
  576.  
  577. See also `4Countdown Window`0 and `4Run a Task`0
  578.  
  579. [TaskDataFile]
  580. `1GoHome`0 stores all the task information in a task data file
  581. (usually this will have a  '.dat' extension). If a task data
  582. file was not specified on the command line (/f=filename),
  583. `1GoHome`0 will assume that the task file is `1tasks.dat`0. If
  584. the task data file does not exist, `1GoHome`0 will create one
  585. that contains room for twenty tasks. To allocate additional
  586. tasks, at any time, use the command line parameters
  587. `3/ALLOC=x`0 and `3/MAX`0 
  588.  
  589. see also `4Command line parameters`0
  590.  
  591.  
  592. [PopCntDown]
  593. A Countdown dialog box is displayed whenever a task is ready
  594. to run. The task will run in 15 seconds unless it is canceled
  595. or delayed. A task can be canceled (won't execure) if the 'C' or ESC
  596. key is pressed. Press 'R' or ENTER to run the task
  597. immediately, or press 'S' to snooze which will delay the task
  598. for 5 minutes. 
  599.  
  600. A number key can also be pressed to delay running the task for
  601. that number of minutes. For instance, if '2' is pressed, the
  602. task is delayed for 2 minutes. However, '0' is the exeception;
  603. it will delay the task for just 15 seconds. The should give
  604. you enough time to save any work that you are working on
  605. before the task is started. 
  606.  
  607. [Log]
  608. A log file is updated each time a task is run. If you don't
  609. want a task to be logged each time its run, you can bring 
  610. up GoSched and select 'Don't Log task' in the `2Advanced dialog`0
  611. box.
  612.  
  613. The log file contains the date and time that the task was 
  614. started and when it completed. It also shows a result code and
  615. the task description. The result is the errorlevel returned
  616. by the last application to run for the task or it is a
  617. negative number indicating that GoHome was unable to run the
  618. task. The following are some of the possible error codes and
  619. their causes:
  620.  
  621.     >= 0   Errorlevel returned by the last application in the
  622.            task to run.
  623.  
  624.    -2      Script file was not found.
  625.    -100    An error occured when trying to save/restore the
  626.            screen image.
  627.    -101    Insufficient disk space.
  628.    -102    Unable to swap the current program to make room for
  629.            the task.
  630.    -103    Unable to swap out the requested amount memory. 
  631.            If the task can run in less memory, reduce the
  632.            minumum memory required in GoSched's Advanced 
  633.            dialog box.
  634.    -104    Swap file could not be created.
  635.    -105    Task data file not found, invalid, or corrupt.
  636.    -106    Unable to restore the program that was interrupted
  637.            so that a task could run. `1GoHome`0 will not be
  638.            able to restore the program if its swap file
  639.            has been deleted. It is therefor `4VERY`0 important
  640.            that you don't delete its swap file.
  641.    -107    Unable to swap out current application to run task
  642.            because in an MS Windows DOS box or an OS/2 DOS 
  643.            box.
  644.  
  645. The log file's name if made up of the current month and year.
  646. It has the following format:  `1GO_mm-yy.log`0 where 'mm' is 
  647. the current month and 'yy' is the last two digits of current
  648. year. The log file is created in the same directory that the
  649. current task data file is in.
  650.  
  651.  
  652. [ChgTime]
  653. It you change your computers time (ie. use DOS's time command)
  654. while GoHome is loaded, you'll need to unload GoHome and then
  655. run GoHome again. This will allow GoHome to schedule the
  656. tasks according to the new time. 
  657.  
  658. [last]
  659. text for last
  660.  
  661. @@EndHelp
  662.  
  663.  
  664.  
  665.  
  666.  
  667. 
  668.